home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / thdpro5.zip / THDTERM.ZIP / THDTERM.DOC next >
Text File  |  1993-02-01  |  7KB  |  125 lines
  1.                         THD ProScan's Terminal Assistant
  2.                        ----------------------------------
  3.  
  4. Messages from a user stating the need for an interface for people who wished 
  5. to use THD ProScan with their terminal program, sparked me to create this 
  6. simple program.
  7.      This program was outwardly inspired by THDPRO TERMINAL EXTENSION. A 
  8. program created for the same basic purpose as this one.
  9.      Keep in mind that this program is really only a glorified batch file. 
  10. Most (if not all) of what it does could easily be done in a batch file. It 
  11. is being provided for those who don't have the time or knowledge to create a 
  12. batch file that performs this task.
  13.  
  14. WHAT WILL I NEED?
  15. -----------------
  16.     You will need a configured copy of THD ProScan (preferably version 5.0).
  17. A directory for files which have not yet been tested (your usual download 
  18. directory is recommended). A directory for files which pass the test and 
  19. another directory for files that fail the test.
  20.      This Terminal assistant will run on any platform which currently 
  21. supports THD ProScan. It will require about 2k of memory above the 
  22. requirements for THD ProScan.
  23.  
  24.  
  25. WHAT DOES IT DO?
  26. ----------------
  27.      Quite simply, It runs THDPRO.EXE on every file in a given directory and 
  28. then moves each of the files to a directory depending on whether it passed 
  29. or failed the test by THDPRO.EXE.
  30.  
  31. WHAT PARAMETERS DOES IT TAKE?
  32. -----------------------------
  33.      The proper Syntax for THD ProScan's Terminal Assistant is quite simply 
  34. "THDTERM.EXE". After it has been configured this command will run the 
  35. program as explained below.
  36.      THDTERM.EXE accepts only a single parameter. "C". Any other parameter 
  37. will result in a simple notice pointing out the correct use. The "C" 
  38. parameter can be used to reconfigure a previously configured file.
  39.  
  40. CONFIGURATION
  41. -------------
  42.      The first time THDTERM.EXE is run it will automatically prompt you for 
  43. 4 things. (no parameters need to be supplied on the first run)
  44. You will be prompted for the following...
  45. Path to THDPRO.EXE
  46. Path to the directory containing the files to be tested.
  47. Path to the directory for passed files.
  48. Path to the directory for failed files.
  49.      ALL of these paths MUST exist prior to the configuration. As mentioned 
  50. above it can be reconfigured by running "THDTERM.EXE C".
  51.  
  52. HOW DOES IT WORK?
  53. -----------------
  54.      THDTERM.EXE counts the files in the directory to be tested and then 
  55. runs THDPRO.EXE on each of the files. IF THD ProScan passes the file, it is 
  56. moved to the directory for "PASSED" files.
  57.      IF THD ProScan fails the file, THD Terminal Assistant will check to see 
  58. if THD ProScan moved the file, If not it will be moved to the directory for 
  59. "FAILED" files.
  60.      It then moves to the next file. At the beginning of testing of each 
  61. file, you will be informed of the number of files to be tested and the 
  62. number of the file about to be tested (ie. "Testing file 4 of 8").
  63.      This program was made to work specifically with THD ProScan Version 5. 
  64. The reason being that it also informs THD ProScan NOT to send output to the 
  65. comport (this will only work with version 5). While it will work with 
  66. previous versions, the remote output will NOT be suppressed on those earlier 
  67. versions.
  68.  
  69. GENERAL INFORMATION
  70. -------------------
  71.      This is an excellent tool for sysops as well as users. For a sysop, it 
  72. will allow them to use THD ProScan Version 5 with their fossil active 
  73. without attempting to send output over the modem. Thus making it the perfect 
  74. tool for a sysop to test his/her downloads.
  75.      Compressing the executeable is recommended for space purposes and has no
  76. adverse affect on the operation. However, Note that it must be configured
  77. before it is compressed and that it cannot be configured or reconfigured in
  78. it's compressed state.
  79.      For users in general it provides the same security that many sysops 
  80. have become accustomed to.
  81.      Needless to say, THDPRO.EXE will need to be configured properly before 
  82. this program will be of any use.
  83.      Reasons for failure are not reported by this program, but all such 
  84. instances should be accounted for in your THDPRO.LOG created by THD ProScan.
  85.      With the exception of possible runtime errors, this program will ALWAYS 
  86. exit with errorlevel "0". The only indicators left by this program will be 
  87. the presence of the tested files in the Pass or fail directory. In keeping 
  88. with the tradition of THD ProScan, this program will NOT delete files for 
  89. any reason. Files are left for you to do with as you choose.
  90.  
  91. DISCLAIMER
  92. ----------
  93.      This progam was concieved,written and tested in less than 24 hours. 
  94. While I do believe it to be stable, I cannot guarantee that it will not do 
  95. damage. In over 100 tests on my system throughout the various stages of 
  96. programming, not a single file was corrupted or lost.
  97.      This program is provided for convenience and comes with absolutely no 
  98. warranty of any sort. If you find it convenient and wish to offer 
  99. suggestions to improve or expand it, all such comments are welcome in the 
  100. BBS support base on TELENET CANADA (TNCNET).
  101.      Address all such comments to David Muir.
  102.  
  103. COPYRIGHT
  104. ---------
  105.                 This  program  and  all of  its  associated  names,
  106.      files, logos and makeup are Copyright 1993 PainSoft.
  107.                 No duplication in whole or in part is allowed. With
  108.      the  exception of  duplication  of the entire  archived set of
  109.      files for distribution to those in need of it's services. None
  110.      of the copyrighted  material may be changed in any way, except
  111.      by the  author.  Changes made  by the " original / unmodified"
  112.      installation  program will be  considered to have been made by
  113.      the author for the purpose of this copyright. The files may be
  114.      rearchived in  ANY fashion which  requires them to be restored
  115.      to their  original condition  before use. ( Portions Copyright
  116.      Borland International)The executable files may be "compressed"
  117.      to save space but may not be  distributed in this  "compressed
  118.      format". The Author accepts no responsibility  for the actions
  119.      of this program. It is FREEWARE  and NO charge may be made for
  120.      it's distribution.  It is NOT a commercial product and as such
  121.      the  ONLY  acceptable charge for it will be  "actual, physical
  122.      cost of duplication". I do not profit  from it  monetarily and
  123.      any attempt of other persons to do  so shall be  considered an
  124.      infringement of my copyright.
  125.